DUMP

Section: File Formats (5)
Updated: June 18, 1985
Index Return to Main Contents
 

NAME

dump, dumpdates - incremental dump format  

SYNOPSIS

#include <sys/types.h>
#include <ufs/inode.h>
#include <protocols/dumprestore.h>  

DESCRIPTION

Tapes used by dump and restore(8) contain:
a header record two groups of bit map records a group of records describing directories a group of records describing files

The format of the header record and of the first record of each description as given in the include file <protocols/dumprestore.h> is:

#define NTREC           10
#define MLEN            16
#define MSIZ            4096

#define TS_TAPE         1
#define TS_INODE        2
#define TS_BITS         3
#define TS_ADDR         4
#define TS_END          5
#define TS_CLRI         6
#define MAGIC           (int) 60011
#define CHECKSUM        (int) 84446

struct  spcl {
        int             c_type;
        time_t          c_date;
        time_t          c_ddate;
        int             c_volume;
        daddr_t         c_tapea;
        ino_t           c_inumber;
        int             c_magic;
        int             c_checksum;
        struct          dinode          c_dinode;
        int             c_count;
        char            c_addr[BSIZE];
} spcl;

struct  idates {
        char            id_name[16];
        char            id_incno;
        time_t          id_ddate;
};

#define DUMPOUTFMT      "%-16s %c %s"           /* for printf */
                                                /* name, incno, ctime(date) */
#define DUMPINFMT       "%16s %c %[^\n]\n"      /* inverse for scanf */

NTREC is the number of 1024 byte records in a physical tape block. MLEN is the number of bits in a bit map word. MSIZ is the number of bit map words.

The TS_ entries are used in the c_type field to indicate what sort of header this is. The types and their meanings are as follows:

TS_TAPE
Tape volume label
TS_INODE
A file or directory follows. The c_dinode field is a copy of the disk inode and contains bits telling what sort of file this is.
TS_BITS
A bit map follows. This bit map has a one bit for each inode that was dumped.
TS_ADDR
A subrecord of a file description. See c_addr below.
TS_END
End of tape record.
TS_CLRI
A bit map follows. This bit map contains a zero bit for all inodes that were empty on the file system when dumped.
MAGIC
All header records have this number in c_magic.
CHECKSUM
Header records checksum to this value.

The fields of the header structure are as follows:

c_type
The type of the header.
c_date
The date the dump was taken.
c_ddate
The date the file system was dumped from.
c_volume
The current volume number of the dump.
c_tapea
The current number of this (1024-byte) record.
c_inumber
The number of the inode being dumped if this is of type TS_INODE.
c_magic
This contains the value MAGIC above, truncated as needed.
c_checksum
This contains whatever value is needed to make the record sum to CHECKSUM.
c_dinode
This is a copy of the inode as it appears on the file system; see fs(5).
c_count
The count of characters in c_addr.
c_addr
An array of characters describing the blocks of the dumped file. A character is zero if the block associated with that character was not present on the file system, otherwise the character is non-zero. If the block was not present on the file system, no block was dumped; the block will be restored as a hole in the file. If there is not sufficient space in this record to describe all of the blocks in a file, TS_ADDR records will be scattered through the file, each one picking up where the last left off.

Each volume except the last ends with a tapemark (read as an end of file). The last volume ends with a TS_END record and then the tapemark.

The structure idates describes an entry in the file /etc/dumpdates where dump history is kept. The fields of the structure are:

id_name
The dumped filesystem is `/dev/id_nam'.
id_incno
The level number of the dump tape; see dump(8).
id_ddate
The date of the incremental dump in system format see types(5).
 

FILES

/etc/dumpdates  

SEE ALSO

dump(8), restore(8), fs(5), types(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 17:18:12 GMT, March 25, 2025